ArcPad Map File Schema
COMBOBOX Element
See Also  Send comments on this topic.
ArcPad Map File Schema > PAGE Element : COMBOBOX Element

Glossary Item Box

Description

Used to define a ComboBox control in a form.

Diagram

LISTITEM Element Sequence COMBOBOX Element

Overview

COMBOBOX
Used to define a ComboBox control in a form.
height required Restriction of xs:int
width required Restriction of xs:int
x required xs:int
The x coordinate of the upper left corner of the combo box.
y required xs:gYearMonth
The y coordinate of the upper left corner of the combo box
backgroundcolor optional xs:string
border optional Restriction of xs:string
color optional xs:string
defaultvalue optional xs:string
field optional xs:string
font optional xs:string
Font name. The name is case sensitive. If font name uses "&", use "&" instead. For example, ESRI Transportation & Civic should be written as ESRI Transportation & Civic.
fontsize optional Restriction of xs:int
Font size.
fontstyle optional Restriction of xs:string
Font style. If the value is not regular, it can be any combination of other values, expressed as a comma delimited list (for example, fontstyle="bold,underline")
group optional Restriction of xs:string
limittolist optional Restriction of xs:string
listtable optional xs:string
listtextfield optional xs:string
listvaluefield optional xs:string
maxvalue optional xs:string
name optional xs:string

When parent is ToolButton:

Custom tool name. Used to reference the tool in scripts.

onchange optional xs:string
Specify the script to run when this event occurs.
oncloseup optional xs:string
Specify the script to run when this event occurs.
ondropdown optional xs:string
Specify the script to run when this event occurs.
onkillfocus optional xs:string
Specify the script to run when this event occurs.
onselcancel optional xs:string
Specify the script to run when this event occurs.
onselchange optional xs:string
Specify the script to run when this event occurs.
onselok optional xs:string
Specify the script to run when this event occurs.
onsetfocus optional xs:string
Specify the script to run when this event occurs.
onvalidate optional xs:string
Specify the script to run when this event occurs.
readonly optional Restriction of xs:string
required optional Restriction of xs:string
sip optional Restriction of xs:string
sort optional Restriction of xs:string
tabstop optional Restriction of xs:string
Sequence
LISTITEM 1..∞
Used to define an item in a ComboBox or ListBox form control.

Attributes

NameTypeUseDefaultFixedDescription
heightRestriction of xs:intrequired   
widthRestriction of xs:intrequired   
xxs:intrequired  The x coordinate of the upper left corner of the combo box.
yxs:gYearMonthrequired  The y coordinate of the upper left corner of the combo box
backgroundcolorxs:stringoptional   
borderRestriction of xs:stringoptionalfalse  
colorxs:stringoptional   
defaultvaluexs:stringoptional   
fieldxs:stringoptional   
fontxs:stringoptional  Font name. The name is case sensitive. If font name uses "&", use "&" instead. For example, ESRI Transportation & Civic should be written as ESRI Transportation & Civic.
fontsizeRestriction of xs:intoptional  Font size.
fontstyleRestriction of xs:stringoptionalregular Font style. If the value is not regular, it can be any combination of other values, expressed as a comma delimited list (for example, fontstyle="bold,underline")
groupRestriction of xs:stringoptionalfalse  
limittolistRestriction of xs:stringoptionaltrue  
listtablexs:stringoptional   
listtextfieldxs:stringoptional   
listvaluefieldxs:stringoptional   
maxvaluexs:stringoptional   
namexs:stringoptional  

When parent is ToolButton:

Custom tool name. Used to reference the tool in scripts.

onchangexs:stringoptional  Specify the script to run when this event occurs.
oncloseupxs:stringoptional  Specify the script to run when this event occurs.
ondropdownxs:stringoptional  Specify the script to run when this event occurs.
onkillfocusxs:stringoptional  Specify the script to run when this event occurs.
onselcancelxs:stringoptional  Specify the script to run when this event occurs.
onselchangexs:stringoptional  Specify the script to run when this event occurs.
onselokxs:stringoptional  Specify the script to run when this event occurs.
onsetfocusxs:stringoptional  Specify the script to run when this event occurs.
onvalidatexs:stringoptional  Specify the script to run when this event occurs.
readonlyRestriction of xs:stringoptionalfalse  
requiredRestriction of xs:stringoptionalfalse  
sipRestriction of xs:stringoptional   
sortRestriction of xs:stringoptionaltrue  
tabstopRestriction of xs:stringoptionaltrue  

Examples

Restrictions

The following attributes can only be used in edit and identify forms. They cannot be used in general forms:

  •  field
  •  required

Source

<xs:element name="COMBOBOX" maxOccurs="1" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:annotation>
    <xs:documentation>Used to define a ComboBox control in a form.</xs:documentation>
  </xs:annotation>
  <xs:complexType>
    <xs:sequence>
      <xs:element ref="LISTITEM" maxOccurs="unbounded" />
    </xs:sequence>
    <xs:attribute use="required" ref="height">
      <xs:annotation>
        <xs:documentation>The height of the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute use="required" ref="width">
      <xs:annotation>
        <xs:documentation>The width of the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute use="required" name="x" type="xs:int">
      <xs:annotation>
        <xs:documentation>The x coordinate of the upper left corner of the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute use="required" name="y" type="xs:gYearMonth">
      <xs:annotation>
        <xs:documentation>The y coordinate of the upper left corner of the combo box</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="backgroundcolor">
      <xs:annotation>
        <xs:documentation>The background color to use for the combo box. If not specified, this value is inherited from the page's backgroundcolor attribute.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="false" ref="border">
      <xs:annotation>
        <xs:documentation>Specifies whether the combo box has a border.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="color">
      <xs:annotation>
        <xs:documentation>The color to use for the combo box's text. If not specified, this value is inherited from the page's color attribute.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="defaultvalue">
      <xs:annotation>
        <xs:documentation>A simple expression that specifies the default value of the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="field">
      <xs:annotation>
        <xs:documentation>The field of the shapefile's DBF table that is linked to the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="font">
      <xs:annotation>
        <xs:documentation>The font to use for the combo box's text. If not specified, this value is inherited from the page's font attribute.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="fontsize">
      <xs:annotation>
        <xs:documentation>The font size to use for the combo box's text. If not specified, this value is inherited from the page's fontsize attribute.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="regular" ref="fontstyle">
      <xs:annotation>
        <xs:documentation>The font style to use for the combo box's text. If not specified, this value is inherited from the page's fontstyle attribute. If the value is not regular, it can be any combination of other values, expressed as a comma delimited list (for example, fontstyle="bold,underline").</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="false" ref="group">
      <xs:annotation>
        <xs:documentation>Specifies whether the combo box starts a new group of controls.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="limittolist" />
    <xs:attribute ref="listtable" />
    <xs:attribute ref="listtextfield" />
    <xs:attribute ref="listvaluefield" />
    <xs:attribute ref="maxvalue" />
    <xs:attribute ref="name" />
    <xs:attribute ref="onchange" />
    <xs:attribute ref="oncloseup" />
    <xs:attribute ref="ondropdown" />
    <xs:attribute ref="onkillfocus">
      <xs:annotation>
        <xs:documentation>Specify the script to run when this event occurs.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="onselcancel" />
    <xs:attribute ref="onselchange" />
    <xs:attribute ref="onselok" />
    <xs:attribute ref="onsetfocus">
      <xs:annotation>
        <xs:documentation>Specify the script to run when this event occurs.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="onvalidate">
      <xs:annotation>
        <xs:documentation>Specify the script to run when this event occurs.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="false" ref="readonly">
      <xs:annotation>
        <xs:documentation>Specifies whether the combo box's value can be modified by the user.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="false" ref="required">
      <xs:annotation>
        <xs:documentation>Specifies if the user must enter some text in the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="true" ref="sip" />
    <xs:attribute ref="sort" />
    <xs:attribute default="true" ref="tabstop">
      <xs:annotation>
        <xs:documentation>Specifies whether the TAB key can be used to move the focus to the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
  </xs:complexType>
</xs:element>

See Also

© 2012 All Rights Reserved.